home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / stadel / stadel1.zoo / runtime / install.st < prev    next >
Encoding:
Text File  |  1988-11-05  |  5.4 KB  |  118 lines

  1. INSTALL.DOC
  2.  
  3.     To quote a paragraph from aabuyme.doc:
  4.  
  5.     STadel is written in Alycon C.  The distributed system can
  6.     be installed and run without recompilation in most cases. 
  7.     STadel needs an Atari ST and an auto-answer modem.
  8.  
  9.     The source files run to about 550K, the .PRG files to about 150K.
  10. In an operating system, the message and userlog files together take
  11. about 150K, and one would normally like about 200K for message text,
  12. to keep the wraparound time longer than a week.
  13.  
  14.     If that doesn't describe your system, this isn't the file for you.
  15. Either recycle the disks, or drag out the source code and
  16. documentation and settle down to some serious hacking...
  17.  
  18.     Still with us?  OK.  For purposes of getting the basic system
  19. working, you need to sort out and get acquainted with the following
  20. files:
  21.  
  22. CONFIGUR.PRG    A special installation program.
  23. CTDLCNFG.SYS    (CiTaDeL CoNFiGuration SYStem file.)  You will edit your
  24.         local system customizations into this file and then
  25.         feed it to CONFIGUR.PRG, which will do all the remaining
  26.         work for you.  (Do you believe that?)
  27. CITADEL.PRG    This is the actual Bulletin Board ("BB" hereafter) program.
  28.  
  29.  
  30.     In order to get lost properly, it is very important to have a map.
  31. Very briefly, the installation steps are:
  32.  
  33.     (1)   Edit CTDLCNFG.SYS.
  34.  
  35.     (2)   Feed CTDLCNFG.SYS into CONFIGUR.PRG.     CONFIGUR.PRG will:
  36.        (A)  Create CTDLLOG.SYS,   a file to contain all the userlog entries.
  37.        (B)  Create CTDLMSG.SYS,   a file to contain all the messages.
  38.        (C)  Create CTDLROOM.SYS,  a file to contain all the rooms.
  39.        (D)  Create CTDLFLOOR.SYS, a file to contain all the floors.
  40.  
  41.        (E)  Create CTDLTABL.SYS,  a file which contains indices to the
  42.                   first four files plus stuff derived
  43.                   from the CTDLCNFG.SYS configuration file.
  44.  
  45.     (3)   Run CITADEL.PRG, which read the above files
  46.       and then let you enter messages, create rooms and all manner of
  47.       good things.
  48.  
  49.  
  50.     Three steps.  How trivial can you get?  But please do study the
  51. above carefully enough to get a feel for what's going on and an
  52. understanding of what the major files do.
  53.  
  54.  
  55. ----------------------------------------------------------------------
  56.  
  57. (1).
  58.     So: go edit CTDLCNFG.SYS.  It's massively self-documented, just
  59. work your way through top to bottom putting in values appropriate to
  60. your system.  You may wish to use a small message-file size during
  61. testing to reduce the length of time CONFIGUR.PRG takes to index the
  62. file.  (It reads through the complete file each time it is run.)
  63.     A few gotchas to watch for:
  64.     CONFIGUR.PRG is not very bright.  It wants to see blanks (not
  65. tabs or carriage-returns) between and following all the fields it
  66. reads.    On the other hand, it really doesn't care what happens on
  67. lines which don't start with "#", or on the trailing half of those
  68. which do.  If you end each instruction line with a comment and put
  69. single blanks between the arguments, as I have, you should have no
  70. problems on this score.  (BASIC programmers: don't worry, the
  71. comments won't slow the system down.  Relax!).
  72.  
  73.  
  74. (2)
  75.     Run CONFIGUR.PRG.  CONFIGUR.PRG expects to find CTDLCNFG.SYS in
  76. the current directory.
  77.     CONFIGUR.PRG is used to rebuild a system as well as install it.
  78. When it fails to find CTDLMSG.SYS, CTDLROOM.SYS, CTDLLOG.SYS or
  79. CTDLFLOOR.SYS, it will create them and remind you to initialize them.
  80. When it asks you if you want to initialize them (and then double
  81. checks on each individual file), type a "Y" each time first time
  82. through.  On subsequent runs, you can answer "N", which will leave
  83. the three data files untouched, only building new indices etc for a
  84. new CTDLTABL.SYS file.  This way you can reconfigure the system
  85. within reasonable limits without trashing all existing messages,
  86. rooms etc.
  87.     CONFIGUR lists various things as it runs, mostly to convince you
  88. it hasn't crashed yet.    Don't worry particularly unless it seems
  89. excited about something. Cheap code?  Well, you get what you pay for...
  90.  
  91. (3)
  92.     Run CITADEL.PRG.  It will expect to find CTDLTABL.SYS in the
  93. current directory when it is run. It will expect to find all the
  94. files in the directories you specified in your CTDLCNFG.SYS.  Copy
  95. all the .HLP, .BLB, and .MNU files to your #helpDir, because that's
  96. where CITADEL.PRG expects to find them.
  97.     
  98.     CITADEL.PRG will delete CTDLTABL.SYS after it has read it, and
  99. will recreate CTDLTABL.SYS only when you exit.  This is because it
  100. contains indices to the other three data files, and it would not be
  101. good to load an out-of-date index file.  If CITADEL.PRG crashes,
  102. leaving you without a CTDLTABL.SYS, just run CONFIGUR.PRG again to
  103. recreate it.
  104.     Play around with CITADEL.PRG for awhile: learn to enter messages,
  105. create rooms, read messages, and so forth.  Create several different
  106. identities, and log them in and out in rotation to see how new
  107. messages and rooms with new messages are found.  (The system is much
  108. easier to understand with lots of rooms and messages around to
  109. experiment on!)
  110.  
  111.     When things are clearly working correctly, try running over the
  112. modem.  You'll need to have someone dialing the system up to test
  113. that carrier-detect etc are working correctly.  This will probably
  114. be painful. Note that you can use "chat mode" to type directly to
  115. the modem, bypassing everything but the modem routines.
  116.  
  117.     If you survive this far... congratulations!   and... Welcome!
  118.